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United Space Alliance 



United Space Alliance, LLC. 


• Our Mission: Provide safe, high-quality, best-value space 
operations, services and technologies to our customers. 

• Capabilities: 

— Engineering Design 

— Space Flight Mission Operations 

— Space Systems Ground Operations & Processing 

— Space Systems Integrated Logistics 

— Space Systems Flight Software 

— Space Systems Integration & Program Management 

• Locations: 

— Texas: Johnson Space Center, Florida: Kennedy Space 
Center, Alabama: Marshall Space Flight Center 
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Migration Setup 



Intralink Production Windchill Production 
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• June, 2008 - Final Deciding Meeting 

— Manually migrate vs. Intralink migration tool 
- 40,000 Files 

• October 1 , 2008 - Intralink server obsolete 

• Training availability - None 

• Time available to procure outside company - Not enough 

• Replacement server - Not an option 
— Remaining options: Self migrate 
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Additional Factors 


• PTC Migration Data Questionnaire - Low complexity 
— Good candidate for customer-led or services-led 

• Backup plan in case of failure 

• Manual migration 

• Computer Engineer on staff 
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“Failure is not an option. ” 


-Apollo 1 3 Movie 
- Based on a quote by Gene Kranz 
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Windchill Setup 

• For purposes of this presentation: 

— I:\ - Intralink W:\ - Windchill 

• Installation will not be covered 
— Pre-Copy option used 

• No Windchill part creation 

* No user-based attributes 

* Primarily Pro/E files 

* Few family tables 
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Different revision schemes 


• Create three StateBasedVersioning.xml files in 

W:\..AIoadFiles\pdmlink 

— Pre-migration (setup) 

— During migration (flat) 

— Post-migration (final) 

• Remove any duplicate scheme values 

• java wt.series.LoadFileBasedSeries <pre-migration> 

• enumCustomize 


• Add new revision scheme type 

• Recompile: Ant -f makejar.xml 


• Selectable in the lifecycle 
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Filed Based Versioning 


• StateBasedVersioning.xml used during migration must be 
a flat file based versioning file with only Intralink scheme 

• Migrator only accepts file based versioning, single 
scheme 

<?xml version-'/! .0" encoding="UTF-8’’?> 

<scheme> 

<series name- ’StateBased"> 

<value>A</value> 

<value>B</value> ... 


•See also PTC TPI1 34560 
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State Based Versioning 


Pre-Migration Setup 

During Migration 

After Migration 

<seed name=“NUMERIC”> 

<series 

name="StateBased"> 

<seed name=“NUMERIC”> 

<seed name="ASME"> 

<value> PRE </value> 

<seed name="MIGRA"> 

<value>-</value> 

<value> - </value> 

<value> PRE </value> 

</seed> 

<value> A </value> 

</seed> 

<seed name="MILSTD"> 
<value> A </value> 

<value> B </value> 

<value> YY </value> 

<seed name="ASME"> 
<value> - </value> 

<value> B </value> 

<value> Y </value> 


<value> A </value> 

<value> B </value> 

<value> YY </value> 
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System Preparations 

• Create lifecycles using new revision scheme 

— Make sure lifecycles are enabled 

• Create workflows if necessary 

— Out of the box vs. customized 

• Verify permissions 

— Do new lifecycle states need new permissions? 

• Setup object initialization rules (OIR) 

— wt.series.HarvardSeries.StateBased 

• Create products and libraries 

— Subfolders will be created by Migrator tool 
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Test Organizer 


• Create Test Organizer 

— Site>Utilities> Business Administration>Attribute 
Definition Manager 


— Name: TestOrganizer 
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Preparations 


Intralink Server 

• Backup Intralink data 

• On Intralink Server 


— l:\...dataserver\intralink\tools\bin\ 

• Locking of Intralink 

• healing_before_migration.tcl 

• Set_common_name.sql (optional as needed) 


• Manually copy files to Windchill server (pre-copy option) 


— Move all data files from Intralink data server To Windchill server 
directory 


Copyright © 2009 by United Space Alliance, LLC. These materials are sponsored by the National Aeronautics and 
Space Administration under Contract NNJ06VA01C. The U.S. Government retains a paid-up, nonexclusive, irrevocable 
worldwide license in such materials to reproduce, prepare, derivative works, distribute copies to the public, and perform 
United Space Alliance P ublic| y and display publicly, by or on behalf of the U.S. Government. All other rights are reserved by the copyright 
owner. 







Preparations 

Windchill Server 

• Backup Oracle database 

— DOS>exp system/<PW>@<user> file=<File 
location/name>.dmp owner=<data owner> 
log=exp.log 

- See also PTC TPI1 32658 

• Backup Site.xconf file 
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Migration. properties 

• W:\ILMigration\codebase\com\ptc\migration\migration.properties 

• Set up during install, but will need to modify 

• ilmigpassword=migchangeme? 

• nonDefaultLDAP= 

• doFileTransfer=False/True 

• truncatelLLargeColumns=false 

• TruncateUDAValue=false 

• LinkToExistingPart=false 
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Windchill Mapping 

- Migration begins here, almost... 


Ildataloader Mapping 


• W:\...ILMigration\bin 

• Step 1: Run Ildataloader Mapping 

[1] - This will test your connections to Intralink 

[2] - This will test your connections to Intralink and 
download the data you need 

• Common Errors: Misspelling the migration password, 
Intralink not being locked down, security permissions 

• Step 2: [6] - Download All data (mapping files) 
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Windchill Mapping 


• Mapping files 

— W:\. . . ILMigration\loadFiles\ilwcmigration 

• Appcreator. properties - Don’t touch 

• Filevaults. properties - Setup file 

• Docrules. properties - Setup file 

• I bamap. properties - Attribute mapping 

• Epm_folder_rsrl_map. properties - File mapping 

• Pitdmapping. properties - Type mapping 

• Usermap. properties - User mapping 


Copyright © 2009 by United Space Alliance, LLC. These materials are sponsored by the National Aeronautics and 
Space Administration under Contract NNJ06VA01C. The U.S. Government retains a paid-up, nonexclusive, irrevocable 
worldwide license in such materials to reproduce, prepare, derivative works, distribute copies to the public, and perform 
United Space Alliance Publicly and display publicly, by or on behalf of the U.S. Government. All other rights are reserved by the copyright 
owner. 





fe&D 


Mapping Files 
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Filevaults. properties - Setup file 


• FILEVAULT.cIntralink 
server>:i:\...\vault=defaultcachevault 

• LOCAL_PRECOPY_PATH.<lntralink 
server>:i:\...\vault=<Windchill server>:W:\...\precopy 
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Docrules. properties - Setup file 

• EPMDOC_NUMBER 

- NAME_WITH_EXTENSION 

- AUTO_NUMBERING 

EPMDOC_NUMBER=NAME_WITH_EXTENSION 

• WTDOC_NUMBER 

- NAME_WITH_EXTENSION 

- AUTO_NUMBERING 

WTDOC NUMBER=NAME WITH EXTENSION 


• Intralink Windchill 

• PTC Common Name = Name 

• Filename = Filename 

• Filename = Number 


— Script to modify Intralink available from PTC: Set_common_name 
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Ibamap. properties - Attribute mapping 

• <Pro/INTRALINK Attribute Name> 

• <Windchill Attribute Name> 
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Epm_folder_rsrl_map.properties - File mapping 
Simple Version 

• RS.BEGIN.70.<lntralink lifecycle> 

— RS.DEF. BEGIN. <lntralink lifecycle> 

• <lntralink lifecycle>=<WC lifecycle> 

• <lntralink lifecycle>.1.<lntralink LC State>=<WC LC state> 

• <lntralink lifecycle>.2. <lntralink LC State>=<WC LC state> 

— RS.DEF. END. <lntralink lifecycle> 

— REPOSITORY=<WC Product/Library> 

• Root Folder/<lntralink folder>=/<WC folder> 

• Root Folder/<lntralink folder>=/<WC folder> 

• RS.END.70. <lntralink lifecycle> 
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Epm_folder_rsrl_map. properties - File mapping 
(Advanced version) 

• Separate products 

• ■ ■ 

Root Folder/<lntralink folder>=/<WC folder> 
Repository = <WC Product/Library> 

Root Folder/<lntralink folder>=/<WC folder> 
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Epm_folder_rsrl_map.properties - File mapping 
(Advanced version) 

• Separate lifecycles 

a a ■ 

Root Folder/<lntralink folder>=/<WC folder> 

# 

RS.DEF. BEGIN. Root Folder Release Scheme 
Root Folder Release Scheme=<WC Life Cycle> 

Root Folder Release Scheme. 1.<lntralink LC State>=<WC LC State> 
RS.DEF. END. Root Folder Release Scheme 
# 

REPOSITORY=<WC Product/Library> 

Root Folder/<lntralink folder>=/<WC folder> 
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Important Tips 

• Folder mapping is case sensitive and space sensitive. 

• Lifecycle states are defined by their system name when 
mapping, no spaces, all upper case 

• Under Review = UNDERREVIEW 






*State: j 

■ k 

Under Review 


■ ▼ 



• Can only change lifecycle on new parts, or upon revision. 



United Space Alliance 


Copyright © 2009 by United Space Alliance, LLC. These materials are sponsored by the National Aeronautics and 
Space Administration under Contract NNJ06VA01C. The U.S. Government retains a paid-up, nonexclusive, irrevocable 
worldwide license in such materials to reproduce, prepare, derivative works, distribute copies to the public, and perform 
publicly and display publicly, by or on behalf of the U.S. Government. All other rights are reserved by the copyright 
owner. 



Pitdmapping. properties - Type mapping 

AnsysOut=0/@OTHER/@OTHER/@NULL/@NULL 

AssemMemblnfo=0/@PROE/@OTHER/@NULL/@PROE_UGC 

Assembly=0/@PROE/@CADASSEMBLY/@NULL/@PROE_UGC 

BendOrder=0/@PROE/@OTHER/@NULL/@PROE_UGC 

BumpMapTexture=0/@OTHER/@OTHER/@NULL/@NULL 


If only migrating Pro/E files, can ignore. 
Otherwise: 

# for EPMDocument: 


pitypedefname=0/@AuthoringApplication/@EPMDocumentType/ 
@SubType/@Category 
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Usermap. properties - User mapping 


• SmithJ = smithj 

• If using Windchill provided LDAP 

— Will create users automatically for you, and duplicate if 
spelling/domain is different 

• If mapping to company controlled LDAP 

— Must map to each specific user and map to LDAP 
(spelling/capitalization) 

— TAN 141054 


• Mapped all files to “Admin” 

• Not suggested for Owner controlled permissions 
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Mapping continued 


• Assuming everything is set up perfectly, you are done 
with the hard part 

• Rarely is it set up 100% correctly 

• lldataloader Mapping 
— [3] - Reconcile data 

• [1] - User data 

• [2] - Folder and release scheme 

• [3] - User attributes 


• [4] - Reconcile all 
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Conflict Resolution 


• Now to see where things went wrong 

• Log Files \N:\...ILMigration\loadXMLFiles\ilwcmigration\reports 

Conflict Report: EPM Folder and ReleaseScheme/Level Mapping Conflicts 


Created On: Sat O 
From: Pro/INTRAL 
Description: This is 


Conflict Report: User Mapping Conflicts 



Description: Invalid 
Resolution: Please si 

Conflicting Data 

52REPOSITORY= 


Created Od: Sat Oct 1 1 14:35:20 EDT 2008 

From: Pro/IfTITlALINK 3.4F000 ( ) To: WindchiD PDMLink 8.0 

Description: This is a list of conflicts generated during user mapping. 


User conflicts during Mapping 


Duplicate Conflicts 

Description. Hie following users ". ere mapped to more than one Intralink user. 
Resolution Please verify that these duplicate entries are intentional 


Conflicting Data 


migrator 
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Reconcile and Repeat until everything is acceptable 
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Loading Data 

From lldataloader Mapping 

• [4] - Load admin data 

— [5] - load all data 

• [5] - Map admin data 

— [6] - map all data 

• [6] - Doc migration rules 


• After each step it is a good idea to check for any errors, any time you 
restart method server isolate logs to isolate problems (logs get pretty 
extensive depending on setting) 

- W:\..\logs 

— W:\... \ILMigration\logs\migration-client.log 
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Loading Data 

From lldataloader Mapping 
• [7] - Pre-configuration of part creation 

— [1] - Download part data (check like mapping data) 

— [2] - Reconcile part data 

— [3] - Load part data 

— [4] - Map part data 

— [5] - Create migration rules 
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Errors 


• If you run into an error you may need to reload the data 
and remap the data 

• The only step you cannot duplicate is “Map all data” 

— Must delete migration site or step through 2,3, 4, 5 

• wt.series.SeriesIncrementOutOfBoundsException: The series value has 
reached its maximum value: YY, series=StateBased 


- Make sure you have every revision of Intralink included 

• The revision value is not valid within the series: Z, series=MilSpec 

- Use state based in 01 R, or make sure it includes every revision 

• java.Iang.NullPointerException 


- ? This error varies 
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Windchill Migration 


• Now begins actual migration 

• lldataloader DocResume 

— Conflict resolution with lldataloader MergeObjects 

• Run>equality>yes 

• Source is master checked for all 

• Items placed based on revision 

— Renaming objects 

• File is created 


• DocResume is where most problems will arise 
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PTC/tfirl 


Windchill Migration 


• lldataloader Document # 

— # = Number of threads/number of processors 

• lldataloader Link # 

• lldataloader FT # 

• lldataloader UDA # 

• lldataloader AsStored # 

• lldataloader Baseline # 

• lldataloader RenameHistory # 

• lldataloader RTPForm # 


Copyright © 2009 by United Space Alliance, LLC. These materials are sponsored by the National Aeronautics and 
Space Administration under Contract NNJ06VA01C. The U.S. Government retains a paid-up, nonexclusive, irrevocable 
worldwide license in such materials to reproduce, prepare, derivative works, distribute copies to the public, and perform 
United Space Alliance publicly and display publicly, by or on behalf of the U.S. Government. All other rights are reserved by the copyright 
owner. 




Windchill Migration 

• lldataloader FileTransfer # 

— Longest running portion 

• lldataloader PostMigrationDataCheck 


• If you choose Windchill part creation 

• lldataloader PartResume 


• lldataloader WTPart # 

• lldataloader BuildProcess # 

• lldataloader Baseline # 
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Ildataloader PostMigrationDataCheck 

• Creates report at 

W:\..AILMigration\logs\postmigrationdatacheck.log 


logs for function: fixNullAttrvalFamTabs 

No. of cells with no definition = 0 
No. of integer/boolean/float cells = 0 
No. of string cells = 0 
No. of timestamp cells = 0 
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Ildataloader MigrationStatus - Report 

• Creates report at W:\..AILMigration\logs\migration-client.log 

Status of Intralink Objects Migration... 


Number of Intralink Objects 
to be migrated 


EPMDocumentMaster # 

EPMDocument # 

WTDocumentMaster # 

WTDocument # 

MemberLink # 

ReferenceLink # 

Files # 

Baselines # 


Number of PDMLink Objects 
actually migrated 

# 

# 

# 

# 

# 

# 

# 

# (with Documents only) + # (with WTParts) 


All DocumentMaster attributes were successfully migrated 
All Document attributes were successfully migrated 
All Link attributes were successfully migrated 
No WTParts were created because you have not specified documents 
for which you want to create WTParts 
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After Migration 

• If you have to, resume Intralink service 

• Upon migration completion lock down Intralink access 

• Backup migration Site.xconf 

• Restore original Site.xconf 
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After Migration 

• Return first created Statebasedversioning.xml file with 
new revision scheme 

• java wt.series.LoadFileBasedSeries 
“W:\.JoadFiles\pdmlink\StateBasedVersioning.xmr -load 
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Additional Tips 

•Try everything on developmental server even if you 
have an empty production server. 

• If you recover from Oracle, make sure to repair it. 

• System Configurator/Xconfmanager 

— Wt.series.integerSeries.min=0 

• Preference Manager 

— /ProjectLink/PDMLinkFoldersAndContentsView = TRUE 

• Make sure all users are trained as close as possible to 
the implementation 
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Helpful Documents 

• Pro/Intralink 8.0 Data Migrator Administrators Guide 

• TPI1 34560 - Filebased versioning scheme to a state-based versioning scheme, 
as part of post migration activities. 

• TPI132621 - An alternate method of file transfer which transfers metadata only 
using "ildataloader FileTransfer <#>" while the files are copied through the O/S 
using the file "fileMap.csv". 

• TPI1 32658 - A simple backup method to restore the blank PDMLink 8.0 

• TP1 1 37992 - ildataloader Document: 

(wt.series.seriesResource/0)wt.series.SerieslncrementOutOfBoundsException“ 

• TPI1 32067 - ildataloader DocResume: java.Iang.NullPointerException 

• TPI140777 - Ildataloader Document :wt.series.SerieslncrementlnvalidException 
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Ifeth) 


So how did things go? 


7/1 5/08 
7/15/08 
7/15/08 

-7/0-7 /AO 

Planning meeting kickoff 
Intralink cleanup - started 
Initial mapping of data 

7/30/08 

8/1 0/08 
QM A/AQ 

Extraction of data - (Make sure you lock Intralink) 
Initial mapping of data - (Check migration password) 

8/1 7/08 

Metadata test migration - (Use a filebased series ) 


Red Lines indicate unsuccessful attempts due to technical issues. 
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So how did things go? 


• 9/14/08 

• 9/25/08 

• 10/10/08 
• 10/10/08 


• 10/10-11/08 
• 10/13/08 


• 8/27/08 Test migration of data #1 - Tool/data validation 

— Does the data migrator tool work on my data? 

• 0/31/00 Tea t m igr a tion o f d a t a # 2 ■ P ro cess va l i d at ion 

— Can you migrate the data in the promised time window? 

• 9 ^ 3/0 8 T c o t mig ra tion e f da t e # 2 P ree eoova lid a tien 

• 9/8fl > ^-- ■■■ Tes t migr a tion e f d a ta # 2 Process va lid a tion 

Test migration of data #2 - Process validation 
Test migration of data #3 - Process validation 
Intralink Goes Down (Friday morning) 

Data migration #3 - Production 
Final validation and preparations to go live 
Windchill goes live (Monday morning) 


(revisions) 

(revisions) 

(revisions) 
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Final Results 


Number of Intralink Objects 
to be migrated 

Number of PDMLink Objects 
actually migrated 

EPMDocumentMaster 

11540 

11540 

EPMDocument 

47046 

47046 

WTDocumentMaster 

1 

1 

WTDocument 

3 

3 

MemberLink 

442605 

442605 

ReferenceLink 

243080 

243080 

Files 

39351 

39350 

Baselines 

1 

1 (with Documents only) + 0 (with WTParts) 


Total files that could not be migrated: 1 

• Total time for final migration, about 8 hours. 

• 8 Total migration runs 

• 7 Tech support calls 
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IfeSl) 



Our IT representative celebrating 
one less resource to manage. 
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fet* 



Questions? 


Steven LaPha Jr. 

United Space Alliance, LLC. 
Steven.G.LaPha@USA-Spaceops.com 
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Color Palette 
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